Writing Drivers for tiie 
DP8390 NIC Family of 
Ethernet Controllers 



INTRODUCTION 

This document provides detailed information for writing driv- 
ers for the NIC Family of Ethernet Controllers; DP8390 NIC, 
DP83901 SNICTM, DP83902 ST-NICtm, and DP83905 
AT/LANTICTM. It describes the basic components of the 
drivers: (1) hardware initialization, (2) initiating transmis- 
sions, and (3) servicing receive and transmit interrupts. It 
includes specific examples of actual network drivers (Driver- 
Initialize, DriverSend, and DriverlSR). We recommend that 
you become familiar with the individual part Data- 
sheets. 

HARDWARE INITIALIZATION 

The initialization procedure supplies configuration parame- 
ters for the NIC Controllers to operate in the current system. 
This involves the CPU loading the proper values into the 
configuration and address registers and enabling the NIC 
Controllers onto the network. The following shows a list of 
parameters that must be initialized before the NIC Control- 
lers become operational. 

— data bus width (8 or 16 bits) 

— physical address 

— types of interrupts that may be serviced 

— size of the Receive Buffer Ring 

— FIFO threshold 

— types of packets that may be received 

An example of an initialization routine for a typical 8-bit sys- 
tem is exemplified in Driverlnitialize. Note that the DATA 
CONFIGURATION register must be initialized before all oth- 
er registers are initialized (except the COMMAND register). 
Note also the sequencing to enable the DP83902 and 
DP83905 onto the network. 

PACKET TRANSMISSION 

The transmit driver is generally partitioned into two parts. 
The first part (DriverSend) initiates a transmission whenever 
the upper level software passes a packet to the driver. If the 
driver is unable to transmit the packet immediately (i.e., the 
transmitter is busy), the supplied packet is queued in a 
transmit-pending buffer. After initiating or queuing up the 
packet, DriverSend returns. 

DriverSend operates in conjunction with an interrupt service 
routine (DriverlSR). After completing the transmission, the 
NIC Controllers interrupt the CPU to signal the end of the 
transmission and indicate status information in the TRANS- 
MIT STATUS register. 

RECEIVE DRIVER 

The responsibility of the receive driver is to transfer data 
from the Receive Buffer Ring to the host's memory. Ideally, 
this process is done as fast as possible to eliminate any 
bottlenecks that may be incurred by the driver. The NIC 
Controllers facilitate removing data from the Ring by provid- 
ing a Remote DMA channel to transfer data from the Ring to 
an I/O port which is readable by the host system. It also 
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maintains two pointers to track packets in the Ring: 
BOUNDARY and CURRENT. These registers respectively 
point to the last unread packet in the Ring and the next 
vacant location in memory to receive another packet. Gen- 
erally, the receive driver removes the next packet pointed to 
by BOUNDARY, then increments BOUNDARY to the suc- 
ceeding packet indicated by the Next Page Pointer in the 
4-byte NIC Controllers receive header. This process contin- 
ues until all packets have been removed from the Ring. 
The NIC Controllers automate packet removal with the 
"send packet" command. When this command is issued, 
the NIC Controllers automatically load the DMA start ad- 
dress with BOUNDARY, load the DMA byte count from the 
4-byte receive header, then begin transferring data. At the 
end of the DMA, the NIC Controllers update BOUNDARY 
with the Next Page Pointer from the receive header. To re- 
move all packets from the Ring, the receive driver simply 
issues the "send packet" command until the BOUNDARY 
and CURRENT registers are equal. 
Because of the asynchronous nature of reception, the re- 
ceive driver must be interrupt driven. Typically, packet re- 
ception is given high priority since delaying packet removal 
may overflow the Receive Buffer Ring. If several packets in 
the ring have been queued, all packets should be removed 
in one process (i.e., a software loop which empties the 
Ring). In heavy traffic conditions, local memory can fill up 
quickly so it is important that the Ring be large enough to 
handle these situations. 

To find out how many packets are lost due to Ring over- 
flows or network errors, the NIC Controllers have three sta- 
tistical registers to monitor the network; FRAME ALIGN- 
MENT ERROR tally, CRC ERROR tally, and FRAMES 
LOST tally. These registers are useful in initially determining 
the size of the Ring and how many packets are lost due to 
network related errors (CRC errors and/or frame alignment 
errors). 

EXAMPLE DRIVERS 

The following transmit and receive drivers are written in as- 
sembly for fast execution. The transmit driver is partitioned 
into two parts, DriverSend and DriverlSR, while the receive 
driver resides entirely within DriverlSR. This section gives an 
overview of DriverlSR, followed by a description on how re- 
ceive and transmit interrupts interact with DriverlSR. 

Interrupt Service Routine (DriverlSR) 

DriverlSR is concerned with interrupts originating from re- 
ceptions, transmissions, and errored transmissions. Errored 
receptions are ignored since these are usually collision frag- 
ments and are of no use to the upper layer software. Driver- 
lSR (Figure 2) consists of (1) a packet transmitted routine 
and (2) a packet received routine. The basic functions of the 
routines are as follows: 

Packet Transmitted Routine: checks the status of all trans- 
missions and transmits the next packets in the transmit- 
pending queue. 
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Packet Received Routine: removes all packets in the re- 
ceive buffer ring by using the "send packet" command of 
the NIC Controllers. 

Transmit Driver 

The transmit drivers consist of two parts. The first part, Dri- 
verSend (Figure 3), initiates transmission when called by the 
upper layer software. DriverSend checks if the NIC Control- 
lers are ready to transmit by reading the COMMAND regis- 
ter (TXP bit is zero). If ready, the DriverSend using the 
DP8390's Remote DMA channel, transfers from the PC's 
memory to local memory, then issues the transmit com- 
mand and returns. Otherwise, if the NIC Controllers are 
busy (TXP bits equal one) DriverSend queues the packet in 
the transmit-pending queue, then returns. 



^ DP8390/901 "S. 
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FIGURE 3. Driver Send Routine 



After a transmission is completed, DriverlSR services the 
interrupt from the NIC Controllers and (1) reports status in- 
formation by reading the TRANSMIT STATUS register and 
(2) transmits the next packet in the transmit-pending queue, 



if any. Thus, for a transmit interrupt, DriverlSR executes the 
following steps: 

1 . Reset PTX bit in INTERRUPT STATUS register. 

2. Check for good transmission by reading the TRANSMIT 
STATUS Register. 

3. If there are more packets in the transmit-pending queue, 
transmit the next packet; otherwise go to 4. 

4. Read INTERRUPT STATUS register for any pending in- 
terrupts. 

Receiver Driver 

Since the receiver driver must be interrupt driven, it resides 
completely within the DriverlSR. When the receive interrupt 
occurs, one or more packets may be buffered into the Ring 
by the NIC Controllers. The DriverlSR removes packets 
from the Ring and then passes them up to the host. Using 
the "send packet" command, packets are removed until the 
Ring is empty, that is, when CURRENT and BOUNDARY 
registers are equal. The sequence of the receive packet 
routine is shown below. 

1 . Reset the PRX bit in the INTERRUPT STATUS register. 

2. Remove the next packet in the receive buffer using the 
"send packet" command. 

3. Check to see if the receive buffer ring is empty: BOUND- 
ARY register = CURRENT PAGE register 

4. If the Ring is not empty, go to 1 ; otherwise read INTER- 
RUPT STATUS register for any more pending interrupts. 

OTHER SOFTWARE CONSIDERATIONS 

The NIC Ethernet Controllers require some special software 
considerations to operate in all network environments. In 
particular, the handling of overflow of the receive buffer ring 
must be handled EXACTLY as described in the data sheet 
and Design Tips. 

The most efficient manner to remove packets from the 
transmit-pending queue is to use Driver Send to initiate 
transmission of the very first packet in the queue; then upon 
completion, use the DriverlSR to transmit the remaining 
packets. Using this method, the DriverlSR examines the 
queue, transmits the next available packet, then exits. The 
DriverlSR transmits the next packet after the NIC Control- 
lers issue the next transmit interrupt. 



Driverlnitialize 



Initializes the NIC for a typical network system. 
Receive Buffer Ring = 2600h to 4000h 
Transmit Buffer = 2000h to 2600h 



Entry: none 



'****Equates for NIC Registers* 



COMMAND 


equ 


300h 


PAGESTARI 


equ 


COMMAND+1 


PAGESTOP 


equ 


COMMAND+2 


BOUNDARY 


equ 


COMMAND+3 


TRANSMIT STATUS 


equ 


COMMAND+4 


TRANSMITPAGE 


equ 


COMMAND+4 


TRANSMITBYIECOUNTO 


equ 


COMMAND+5 


NCR 


equ 


COMMAND+5 


TRANSMITBYIECOUNTl 


equ 


COMMAND+6 


INTERRUPISIATUS 


equ 


COMMAND+7 


CURRENT 


equ 


COMMAND+7 


REMOTESTARTADDRESSO 


equ 


COMMAND+8 


CRDMAO 


equ 


COMMAND+8 


REMOTESTARIADDRESSl 


equ 


COMMAND+9 


CRDMAl 


equ 


COMMAND+9 


REMOTEBYIECOUNTO 


equ 


COMMAND+Oah 


REMOTEBYIECOUNTl 


equ 


COMMAND+Obh 


RECEIVESIAIUS 


equ 


COMMAND+Och 


RECEIVECONFIGURATION 


equ 


COMMAND+Och 


TRANSMITCONFIGURAIION 


equ 


COMMAND+Odh 


FAE_ TALLY 


equ 


COMMAND+Odh 


DATACONFIGURATION 


equ 


COMMAND+Oeh 


CRC.TALLY 


equ 


COMMAND+Oeh 


INTERRUPIMASK 


equ 


COMMAND+Ofh 


MISS_PKT_TALLY 


equ 


COMMAND+Ofh 


PSTART 


equ 


46h 


PSTOP 


equ 


80h 



;in page 1 



CGroup group Code 

Code segment para public 'Code' 

assume cs;CGroup, ds:CGroup, es:nothlng, ss:nothlng 



rcr 


db 





tcr 


db 





dcr 


db 


58h 


Imr 


db 


Obh 



;value for Recv conflg. reg 
;value for trans, conflg. reg 
;value for data conflg. reg 
;value for Intr. mask reg 



.!:!^!:!*!i!*^!:!^ 
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Driverlnit 


Lallze proc near 




publ 


LC Driverlnitialize 




mov 


al,21h 


;stop mode 


mov 


dx, COMMAND 




out 


dx,al 




mov 


al,dcr 




mov 


dx.DAIACONFIGURAIION 


;data configuration register 


out 


dx.al 




mov 


dx , REMOTEBYTECOUNTO 




xor 


al.al 




out 


dx.al 


;low remote byte count 


mov 


dx.REMOIEBYTECOUNTl 




out 


dx,al 


;high remote byte count 


mov 


al.ror 




mov 


dx.RECEIVECONEIGURAIION 


;receive configuration register 


out 


dx.al 




mov 


al,20h 




mov 


dx.IRANSMITPAGE 


;transmit page start 


out 


dx.al 




mov 


al.02 




mov 


dx.IRANSMITCONFIGURATION 




out 


dx.al 


;temporarily go into Loopback mode 


mov 


al.26h 




mov 


dx.PAGESTART 


;page start 


out 


dx.al 




mov 


dx. BOUNDARY 


;boundary register 


out 


dx.al 




mov 


al.40h 




mov 


dx.PAGESTOP 


;page stop 


out 


dx.al 




mov 


al.eih 


;go to page 1 registers 


mov 


dx. COMMAND 




out 


dx.al 




mov 


al.26h 




mov 


dx. CURRENT 


;current page register 


out 


dx.al 




mov 


al.22h 


;back to page 0, start mode 


mov 


dx. COMMAND 




out 


dx.al 




mov 


al.Offh 




mov 


dx.INIERRUPTSTATUS 


;interrupt status register 


out 


dx.al 




mov 


al.imr 




mov 


dx.INIERRUPTMASK 


;interrupt mask register 


out 


dx.al 




mov 


dx.IRANSMITCONFIGURATION 




mov 


al.tor 




out 


dx.al 
ret 


;TCR in normal mode. NIC is now 
;ready for reception 


Driverlnitialize endp 




Code 


ends 
end 





DrlverSend 

Either transmits a packet passed to it or queues up the 
packet if the transmitter is busy (COMMAND register = 26h) , 
Routine is called from upper layer software. 



Entry: 



ds :si 
ox 



=> packet to be transmitted 
:> byte count of packet 



*Equates for NIC Registers* 



COMMAND 


equ 


300h 




PAGESTART 


equ 


COMMAND+1 




PAGESTOP 


equ 


COMMAND+2 




BOUNDARY 


equ 


COMMAND+3 




TRANSMIT STATUS 


equ 


COMMAND+4 




TRANSMITPAGE 


equ 


COMMAND+4 




TRANSMIIBYIECOUNTO 


equ 


COMMAND+5 




NCR 


equ 


COMMAND+5 




TRANSMITBYTECOUNTl 


equ 


COMMAND+6 




INTERRUPISIATUS 


equ 


COMMAND+7 




CURRENT 


equ 


COMMAND+7 


;in page 


REMOTESTARIADDRESSO 


equ 


COMMAND+8 




CRDMAO 


equ 


COMMAND+8 




REMOTESTARTADDRESSl 


equ 


COMMAND+9 




CRD MAI 


equ 


COMMAND+9 




REMOTEBYIECOUNTO 


equ 


COMMAND+Oah 




REMOTEBYTECOUNTl 


equ 


COMMAND+Obh 




RECEIVESTAIUS 


equ 


COMMAND+Och 




RECEIVECONFIGURATION 


equ 


COMMAND+Och 




TRANSMITCONFIGURAIION 


equ 


COMMAND+Odh 




FAE_ TALLY 


equ 


COMMAND+Odh 




DATACONFIGURATION 


equ 


COMMAND+Oeh 




CRC.TALLY 


equ 


COMMAND+Oeh 




INTERRUPIMASK 


equ 


COMMAND+Ofh 




MISS_PKT_TALLY 


equ 


COMMAND+Ofh 




lOPORT 


equ 


COMMAND+lOh 




PSTART 


equ 


46h 




PSTOP 


equ 


80h 




TRANSMITBUFFER 


equ 


40h 





.CODE 



DrlverSend 


proc near 


public 


DrlverSend 


oil 




mov 


dx, COMMAND 


in 


al.dx 


cmp 


26h 


je 


Queuelt 



;disable interrupts 

;read NIC command register 

;transmitting? 

;if so, queue packet 



push ex ;store byte count 

mov ah.IRANSMIIBUFFER 

xor al.al ;set page to transfer packet to 

call PCtoNIC ;transfer packet to NIC buffer RAM 

mov dx.IRANSMIIPAGE 

mov al.IRANSMIIBUFFER 

out dx.al ;set NIC transmit page 

pop ex ;get byte count back 

mov dx.TRANSMITBYIECOUNIO 

mov al.cl 

out dx.al ;set transmit byte count on NIC 

mov dx.IRANSMITBYTECOUNIl 

mov al.ch 

out dx.al ;set transmit byte count 1 on NIC 

mov dx, COMMAND 

mov al,28h 

out dx.al ;lssue transmit to COMMAND register 

jmp Finished 

Queuelt : 

call Queue_packet 
Finished: ;enable interrupts 

sti 

ret 

DriverSend endp 
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TTTTTTT-fTTTTTTTTTTTTT-fTT-1-T 


PCtoNIC 




This routine 


will transfer a packet fr 


om the PC's RAM 




to the local 


RAM on the NIC card. 






assumes : 


ds : si = packet to be transferred 






ex = byte count 








ax = NIC buffer page 


to transfer to 




'J^A'J^<<,ml,*K,J,'J^A'J^AJ,A 
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TTTTT-1-TTTTT-CT 


■''r-T*-T*T*TT*TT*T*-T*^k*-TT*TT*'r-T*T*-T*T*'rT*'rT*T 


■T*T*TT*'rT*T*-T*T*-T*T*'rT*T-T*T*-T*T*TT-T'r-T*-TT*-TT*TT*T*-T*T* 


public 


..PCtoNIC 




PCtoNIC proo 


far 




push 


ax 


; save buffer address 


Ino 


ex 


; make even 


and 


cx.Offfeh 




mov 


dx , REMOTEBYTECOUNTO 


; set byte count low byte 


mov 


al.cl 




out 


dx.al 




mov 


dx , REMOIEBYIECOUNTl 


; set byte count high byte 


mov 


al.ch 




out 


dx.al 




pop 


ax 


; get our page back 


mov 


dx.REMOTESIARIADDRESSO 




out 


dx.al 


; set as lo address 


mov 


dx.REMOTESIARTADDRESSl 




mov 


al.ah 


; set as hi address 


out 


dx.al 




mov 


dx, COMMAND 




mov 


al , 12h 


; write and start 


out 


dx.al 




mov 


dx.IOPORT 




shr 


cx,l 


; need to loop half as many times 


Wrlting.Word: 




;because of word-wide transfers 


lodsw 




;load word from ds:si 


out 


dx.ax 


;write to lOPORT on NIC board 


loop 


Writing.Word 




mov 


cx,0 




mov 


dx.INIERRUPTSTATUS 




CheokDMA: 






in 


al.dx 




test 


al,40h 


; dma done ??? 


jnz 


toNICEND 


; if so, go to NICEND 


Jmp 


CheckDMA 


;loop until done 


toNICEND: 






mov 


dx.INTERRUPTSTATUS 




mov 


al,40h 


;clear DMA interrupt bit in ISR 


out 


dx,al 




olo 






ret 






PCtoNIC 


endp 





NICtoPC 

This routine will transfer a packet from the RAM 
on the NIC card to the RAM In the PC. 

assumes: es: dl = packet to be transferred 
ox = byte count 
ax = NIC buffer page to transfer from 



public .NICtoPC 



.NICtoPC 


proc far 


push 


ax 


Inc 


ex 


and 


cx.Offfeh 


mov 


dx , REMOTEBYTECOUNIO 


mov 


al.cl 


out 


dx.al 


mov 


dx , REMOTEBYTECOUNIl 


mov 


al.ch 


out 


dx.al 


pop 


ax 


mov 


dx.REMOTESIARTADDRESSO 


out 


dx.al 


mov 


dx.REMOTESIARTADDRESSl 


mov 


al.ah 


out 


dx.al 


mov 


dx, COMMAND 


mov 


al.Oah 


out 


dx.al 


mov 


dx.IOPORI 


shr 


cx,l 


Writlng.Word: 




In 


ax,dx 


stosw 




loop 


Reading. Word 


mov 


dx.INTERRUPTSTAIUS 


CheckDMA: 




in 


al ,dx 


test 


al,40h 


Jnz 


ReadEnd 


jmp 


CheckDMA 


ReadEnd : 




out 


dx.al 


ret 




.NICtoPC 


endp 



; save buffer address 
; make even 



; get our page back 
; set as low address 

; set as hi address 
: read and start 



; need to loop half as many times 
;because of word-wide transfers 

;read word and store in es;di 



; clear RDMA bit in NIC ISR 



DriverlSR 



This interrupt service routine responds to transmit, transmit error, and 
receive interrupts (the FIX, TXE, and PRX bits in the INTERRUPT STATUS 
register) produced from the NIC. Upon transmit interrupts, the upper 
layer software is informed of successful or erroneous transmissions ; 
upon receive interrupts, packets are removed from the Receive Buffer 
Ring (in local memory) and transferred to the PC. 



'****Equates for NIC Registers* 



COMMAND 


equ 


300h 




PAGESTART 


equ 


COMMAND+1 




PAGESTOP 


equ 


COMMAND+2 




BOUNDARY 


equ 


COMMAND+3 




TRANSMITSTATUS 


equ 


COMMAND+4 




TRANSMITPAGE 


equ 


COMMAND+4 




TRANSMITBYIECOUNTO 


equ 


COMMAND+5 




NCR 


equ 


COMMAND+5 




TRANSMITBYIECOUNTl 


equ 


COMMAND+6 




INTERRUPISIATUS 


equ 


COMMAND+7 




CURRENT 


equ 


COMMAND+7 


;in page 


REMOTESTARIADDRESSD 


equ 


COMMAND+8 




CRD MAO 


equ 


COMMAND+8 




REMOTESTARTADDRESSl 


equ 


COMMAND+9 




CRD MAI 


equ 


COMMAND+9 




REMOTEBYIECOUNTO 


equ 


COMMAND+Oah 




REMOTEBYIECOUNTl 


equ 


COMMAND+Obh 




RECEIVESIAIUS 


equ 


COMMAND+Och 




RECEIVECONFIGURATION 


equ 


COMMAND+Och 




TRANSMITCONFIGURATION 


equ 


COMMAND+Odh 




FAE_ TALLY 


equ 


COMMAND+Odh 




DATACONFIGURATION 


equ 


COMMAND+Oeh 




CRC.TALLY 


equ 


COMMAND+Oeh 




INTERRUPIMASK 


equ 


COMMAND+Ofh 




MISS_PKT_TALLY 


equ 


COMMAND+Ofh 




PSTART 


equ 


46h 




PSTOP 


equ 


80h 





CGroup group Code 

Code segment para public 'Code' 

assume cs:CGroup, ds:CGroup, es:nothing, ss:nothing 
; External routines 

extrn DriverSend: near 
byte.oount dw ? 
imr db Ibh ;image of Interrupt Mask register 



10 



Begin of Interrupt Service Routine 



netisr proo 


near 


public netisr 


cli 




push 


ax 


push 


bx 


push 


ox 


push 


dx 


push 


di 


push 


si 


push 


ds 


push 


es 


push 


bp 


mov 


al.Obch 


out 


21h,al 


sti 




mov 


ax.CGroup 


mov 


ds.ax 



;save regs 



;turn off IRQ3 



:ds=cs 



Read INTERRUPT STATUS REGISTER for receive packets, 
packets and errored transmitted packets. 



transmitted 



poll: 



mov 


dx.INTERRUPTSTATUS 


in 


al,dx 


test 


al,l 


jnz 


pkt_recv_rt 


test 


al.Oah 


jz 


exit_isr 


jmp 


pkt_tx_rt 


isr: 




mov 


dx.INTERRUPTMASK 


mov 


al,0 


out 


dx.al 


cli 




mov 


al,0b4h 


out 


21h,al 


mov 


al,63h 


out 


20h,al 


sti 




mov 


dx.INTERRUPTMASK 


mov 


al.imr 


out 


dx.al 



;packet received? 

;paoket transmitted? 
:no. let's exit 



;disabling NIC's intr 

;turn IRQ3 back on 
;send 'EOI' for IRQ3 



NOTE: intr from the NIC 
are enabled at this point so 
that the 8259 interrupt 
controller does not miss any 
IRQ edges from the NIC 
(IRQ is edge sensitive) 



pop 


bp 


pop 


es 


pop 


ds 


pop 


si 


pop 


di 


pop 


dx 


pop 


ox 


pop 


bx 


pop 


ax 


iret 
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Packet 


Receive Routine (pkt.recv.rt) - clears out all good 




packets 


In local receive buffer ring. Bad packets are ignored. 




j;:^!:!^^;;;^;;;^!:! 
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pkt_recv_rt 




mov 


dx.INIERRUPISTATUS 


In 


al.dx 


test 


al.lOh ;test for a Ring overflow 


jnz 


rlng_ovfl 


mov 


al,l 


out 


dx.al ;reset PRX bit in ISR 


mov 


ax,next_packet 


mov 


ex, packet _length 


mov 


es.seq recv_pc_buff 


mov 


dl, off set recv_pc_buff 


NICto 


PC 




Inform 


upper layer software of a received packet to be processed 




>^:^>^:^^i)i^-^^-^ 


^j;!****;;!^;;!!:!***;:!*;;!^***!:;^*^;:!**!:;*;;!^;;!**!:;*;;!^;:!^*!!!*!!!^!:!*!:!!!!*!!!*!:!^!:!^*!!!*!:!!^ 




checking to see if receive buffer ring is empty 


oheok_ring: 




mov 


dx, BOUNDARY 


In 


al.dx 


mov 


ah.al ;save BOUNDARY in ah 


mov 


dx, COMMAND 


mov 


al,62h 


out 


dx.al ;switohed to pg 1 of NIC 


mov 


dx. CURRENT 


in 


al.dx 


mov 


bh.al ;bh = CURRENT PAGE register 


mov 


dx. COMMAND 


mov 


al.22h 


out 


dx.al ;switohed back to pg 


cmp 


ah.bh ;reov buff ring empty? 


Jne 


pkt_recv_rt 


Jmp 


poll 




•^ t. -^ ^ lii :^ lii '^ 1^ !ii 


^Jltjli^sli^j;!^;:!!;;^*^;:!!^;:!^^^^;;;^;;!^;:!!^^;;;^;:!^;:;;!;^!;;^;:!^;:!!^^;;;^!!;^;:!^;:!;^^;!;^;:!^;:!^^;!;^;:!^ 




The following code Is required to recover from a Ring overflow. 




See Sec 


. 2.0 of datasheet addendum. 




j;:^!:!^^*^*^!:! 


^!:!*!i!*^!:!^!:!*!i!*^!:!^!:!^^*^*^!:!^!:!*^*!i!!:!^!:!*^*!i!!:!^!:!^^*!i!*^!:!^!:!*^jii^j:!^j:!^^jii^j:!^ 


ring_ovf 1 ; 




mov 


dx. COMMAND 


mov 


al.21h 


out 


dx.al ;put NIC in stop mode 


mov 


dx.REMOIEBYTECOUNTO 


xor 


al.al 


out 


dx.al 


mov 


dx.REMOIEBYTECOUNTl 


out 


dx.al 


mov 


dx._INTERRUPISIATUS 


mov 


cx.7fffh ;load time out counter 



12 



wait_for_stop: 

In al.dx 

test al,80h ;look for RST bit to be set 

loop walt_for_stop ; if we fall thru this loop, the RST bit may not get 

; set because the NIC was currently transmitting 
mov dx.TRANSMITCONFIGURATION 
mov al,2 

out dx.al ;into loopback mode 1 

mov dx, COMMAND 
mov al,22h 
out dx.al ;into stop mode 

mov ax,next_packet 
mov cx,packet_length 
mov es.seg reov_pc_buff 
mov di, off set recv_po_buff 
NICtoPC 



mov dx.INIERRUPTSTATUS 
mov al.lOh 
out dx.al 



;clear Overflow bit 



mov dx.TRANSMITCONFIGURATION 

mov al.tcr 

out dx.al ;put TCR back to normal mode 

jmp oheck.ring 



packet_transmit_routine (pkt_tx_rt) -determine status of 
transmitted packet, then checks the transmit-pending 
queue for the next available packet to transmit. 



pkt_tx_rt : 

mov dx.INIERRUPTSTATUS 

mov al.Oah 

out dx.al 

mov dx.TRANSMITSTATUS 

in al.dx 

test al.38h 

jnz bad.tx 



;reset PTX and TXE bits in ISR 

;check for erroneous TX 

;is FU. CRS. or ABT bits set in TSR 



Inform upper layer software of successful transmission 



jmp chk_tx_queue 



bad_tx: 



:in here if bad TX 



Inform upper layer software of erroneous transmission 
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ohk_tx_queue : 

call Cheok.Queue 

cmp cx,0 
je poll 
call DriverSend 
jmp poll 
netisr endp 



; see if a packet Is in queue 

; assume Check_Queue will a non-zero 

; value in ex and pointer to the 

; packet in DS:SI if packet is 

: available. Returns ex = otherwise 
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LIFE SUPPORT POLICY 

NATIONAL'S PRODUCTS ARE NOT AUTHORIZED FOR USE AS CRITICAL COMPONENTS IN LIFE SUPPORT 
DEVICES OR SYSTEMS WITHOUT THE EXPRESS WRITTEN APPROVAL OF THE PRESIDENT OF NATIONAL 
SEMICONDUCTOR CORPORATION. As used herein; 

1. Life support devices or systems are devices or 2. A critical component is any component of a life 

systems which, (a) are intended for surgical implant support device or system whose failure to perform can 

into the body, or (b) support or sustain life, and whose be reasonably expected to cause the failure of the life 

failure to perform, when properly used in accordance support device or system, or to affect its safety or 

with instructions for use provided in the labeling, can effectiveness, 
be reasonably expected to result in a significant injury 
to the user. 
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